Introduction
1.
I. Spring Boot文档
1.1.
1. 关于本文档
1.2.
2. 获取帮助
1.3.
3. 第一步
1.4.
4. 使用Spring Boot
1.5.
5. 了解Spring Boot特性
1.6.
6. 迁移到生存环境
1.7.
7. 高级主题
2.
II. 开始
2.1.
8. Spring Boot介绍
2.2.
9. 系统要求
2.2.1.
9.1. Servlet容器
2.3.
10. Spring Boot安装
2.3.1.
10.1. 为Java开发者准备的安装指南
2.3.1.1.
10.1.1. Maven安装
2.3.1.2.
10.1.2. Gradle安装
2.3.2.
10.2. Spring Boot CLI安装
2.3.2.1.
10.2.1. 手动安装
2.3.2.2.
10.2.2. 使用GVM安装
2.3.2.3.
10.2.3. 使用OSX Homebrew进行安装
2.3.2.4.
10.2.4. 使用MacPorts进行安装
2.3.2.5.
10.2.5. 命令行实现
2.3.2.6.
10.2.6. Spring CLI示例快速入门
2.3.3.
10.3. 从Spring Boot早期版本升级
2.3.4.
11. 开发你的第一个Spring Boot应用
2.3.5.
11.1. 创建POM
2.3.6.
11.2. 添加classpath依赖
2.3.7.
11.3. 编写代码
2.3.7.1.
11.3.1. @RestController和@RequestMapping注解
2.3.7.2.
11.3.2. @EnableAutoConfiguration注解
2.3.7.3.
11.3.3. main方法
2.3.8.
11.4. 运行示例
2.3.9.
11.5. 创建一个可执行jar
2.3.10.
12. 接下来阅读什么
3.
III. 使用Spring Boot
3.1.
13. 构建系统
3.1.1.
13.1. Maven
3.1.1.1.
13.1.1. 继承starter parent
3.1.1.2.
13.1.2. 使用没有父POM的Spring Boot
3.1.1.3.
13.1.3. 改变Java版本
3.1.1.4.
13.1.4. 使用Spring Boot Maven插件
3.1.2.
13.2. Gradle
3.1.3.
13.3. Ant
3.1.4.
13.4. Starter POMs
3.2.
14. 组织你的代码
3.2.1.
14.1. 使用"default"包
3.2.2.
14.2. 定位main应用类
3.3.
15. 配置类
3.3.1.
15.1. 导入其他配置类
3.3.2.
15.2. 导入XML配置
3.4.
16. 自动配置
3.4.1.
16.1. 逐步替换自动配置
3.4.2.
16.2. 禁用特定的自动配置
3.5.
17. Spring Beans和依赖注入
3.6.
18. 使用@SpringBootApplication注解
3.7.
19. 运行应用程序
3.7.1.
19.1. 从IDE中运行
3.7.2.
19.2. 作为一个打包后的应用运行
3.7.3.
19.3. 使用Maven插件运行
3.7.4.
19.4. 使用Gradle插件运行
3.7.5.
19.5. 热交换
3.8.
20. 打包用于生产的应用程序
3.9.
21. 接下来阅读什么
4.
IV. Spring Boot特性
4.1.
22. SpringApplication
4.1.1.
22.1. 自定义Banner
4.1.2.
22.2. 自定义SpringApplication
4.1.3.
22.3. 流畅的构建API
4.1.4.
22.4. Application事件和监听器
4.1.5.
22.5. Web环境
4.1.6.
22.6. 命令行启动器
4.1.7.
22.7. Application退出
4.2.
23.外化配置
4.2.1.
23.1. 配置随机值
4.2.2.
23.2. 访问命令行属性
4.2.3.
23.3. Application属性文件
4.2.4.
23.4. 特定的Profile属性
4.2.5.
23.5. 属性占位符
4.2.6.
23.6. 使用YAML代替Properties
4.2.6.1.
23.6.1. 加载YAML
4.2.6.2.
23.6.2. 在Spring环境中使用YAML暴露属性
4.2.6.3.
23.6.3. Multi-profile YAML文档
4.2.6.4.
23.6.4. YAML缺点
4.2.7.
23.7. 类型安全的配置属性
4.2.7.1.
23.7.1. 第三方配置
4.2.7.2.
23.7.2. 松散的绑定（Relaxed binding）
4.2.7.3.
23.7.3. @ConfigurationProperties校验
4.3.
24. Profiles
4.3.1.
24.1. 添加激活的配置(profiles)
4.3.2.
24.2.以编程方式设置profiles
4.3.3.
24.3. Profile特定配置文件
4.4.
25. 日志
4.4.1.
25.1. 日志格式
4.4.2.
25.2. 控制台输出
4.4.3.
25.3. 文件输出
4.4.4.
25.4. 日志级别
4.4.5.
25.5. 自定义日志配置
4.5.
26. 开发Web应用
4.5.1.
26.1. Spring Web MVC框架
4.5.1.1.
26.1.1. Spring MVC自动配置
4.5.1.2.
26.1.2. HttpMessageConverters
4.5.1.3.
26.1.3. MessageCodesResolver
4.5.1.4.
26.1.4. 静态内容
4.5.1.5.
26.1.5. 模板引擎
4.5.1.6.
26.1.6. 错误处理
4.5.1.7.
26.1.7. Spring HATEOAS
4.5.2.
26.2. JAX-RS和Jersey
4.5.3.
26.3. 内嵌servlet容器支持
4.5.3.1.
26.3.1. Servlets和Filters
4.5.3.2.
26.3.2. EmbeddedWebApplicationContext
4.5.3.3.
26.3.3. 自定义内嵌servlet容器
4.5.3.4.
26.3.4. JSP的限制
4.6.
27. 安全
4.7.
28. 使用SQL数据库
4.7.1.
28.1. 配置DataSource
4.7.1.1.
28.1.1. 对内嵌数据库的支持
4.7.1.2.
28.1.2. 连接到一个生产环境数据库
4.7.1.3.
28.1.3. 连接到一个JNDI数据库
4.7.2.
28.2. 使用JdbcTemplate
4.7.3.
28.3. JPA和Spring Data
4.7.3.1.
28.3.1. 实体类
4.7.3.2.
28.3.2. Spring Data JPA仓库
4.7.3.3.
28.3.3. 创建和删除JPA数据库
4.8.
29. 使用NoSQL技术
4.8.1.
29.1. Redis
4.8.1.1.
29.1.1. 连接Redis
4.8.2.
29.2. MongoDB
4.8.2.1.
29.2.1. 连接MongoDB数据库
4.8.2.2.
29.2.2. MongoDBTemplate
4.8.2.3.
29.2.3. Spring Data MongoDB仓库
4.8.3.
29.3. Gemfire
4.8.4.
29.4. Solr
4.8.4.1.
29.4.1. 连接Solr
4.8.4.2.
29.4.2. Spring Data Solr仓库
4.8.5.
29.5. Elasticsearch
4.8.5.1.
29.5.1. 连接Elasticsearch
4.8.5.2.
29.5.2. Spring Data Elasticseach仓库
4.9.
30. 消息
4.9.1.
30.1. JMS
4.9.1.1.
30.1.1. HornetQ支持
4.9.1.2.
30.1.2. ActiveQ支持
4.9.1.3.
30.1.3. 使用JNDI ConnectionFactory
4.9.1.4.
30.1.4. 发送消息
4.9.1.5.
30.1.5. 接收消息
4.10.
31. 发送邮件
4.11.
32. 使用JTA处理分布式事务
4.11.1.
32.1. 使用一个Atomikos事务管理器
4.11.2.
32.2. 使用一个Bitronix事务管理器
4.11.3.
32.3. 使用一个J2EE管理的事务管理器
4.11.4.
32.4. 混合XA和non-XA的JMS连接
4.11.5.
32.5. 支持可替代的内嵌事务管理器
4.12.
33. Spring集成
4.13.
34. 基于JMX的监控和管理
4.14.
35. 测试
4.14.1.
35.1. 测试作用域依赖
4.14.2.
35.2. 测试Spring应用
4.14.3.
35.3. 测试Spring Boot应用
4.14.3.1.
35.3.1. 使用Spock测试Spring Boot应用
4.14.4.
35.4. 测试工具
4.14.4.1.
35.4.1. ConfigFileApplicationContextInitializer
4.14.4.2.
35.4.2. EnvironmentTestUtils
4.14.4.3.
35.4.3. OutputCapture
4.14.4.4.
35.4.4. TestRestTemplate
4.15.
36. 开发自动配置和使用条件
4.15.1.
36.1. 理解auto-configured beans
4.15.2.
36.2. 定位auto-configuration候选者
4.15.3.
36.3. Condition注解
4.15.3.1.
36.3.1. Class条件
4.15.3.2.
36.3.2. Bean条件
4.15.3.3.
36.3.3. Property条件
4.15.3.4.
36.3.4. Resource条件
4.15.3.5.
36.3.5. Web Application条件
4.15.3.6.
36.3.6. SpEL表达式条件
4.16.
37. WebSockets
4.17.
38. 接下来阅读什么
5.
V. Spring Boot执行器: Production-ready特性
5.1.
39. 开启production-ready特性
5.2.
40. 端点
5.2.1.
40.1. 自定义端点
5.2.2.
40.2. 健康信息
5.2.3.
40.3. 安全与HealthIndicators
5.2.3.1.
40.3.1. 自动配置的HealthIndicators
5.2.3.2.
40.3.2. 编写自定义HealthIndicators
5.2.4.
40.4. 自定义应用info信息
5.2.4.1.
40.4.1. 在构建时期自动扩展info属性
5.2.4.2.
40.4.2. Git提交信息
5.3.
41. 基于HTTP的监控和管理
5.3.1.
41.1. 保护敏感端点
5.3.2.
41.2. 自定义管理服务器的上下文路径
5.3.3.
41.3. 自定义管理服务器的端口
5.3.4.
41.4. 自定义管理服务器的地址
5.3.5.
41.5. 禁用HTTP端点
5.3.6.
41.6. HTTP Health端点访问限制
5.4.
42. 基于JMX的监控和管理
5.4.1.
42.1. 自定义MBean名称
5.4.2.
42.2. 禁用JMX端点
5.4.3.
42.3. 使用Jolokia通过HTTP实现JMX远程管理
5.4.3.1.
42.3.1. 自定义Jolokia
5.4.3.2.
42.3.2. 禁用Jolokia
5.4.4.
43. 使用远程shell来进行监控和管理
5.4.4.1.
43.1. 连接远程shell
5.4.4.1.1.
43.1.1. 远程shell证书
5.4.4.2.
43.2. 扩展远程shell
5.4.4.2.1.
43.2.1. 远程shell命令
5.4.4.2.2.
43.2.2. 远程shell插件
5.4.5.
44. 度量指标（Metrics）
5.4.5.1.
44.1. 系统指标
5.4.5.2.
44.2. 数据源指标
5.4.5.3.
44.3. Tomcat session指标
5.4.5.4.
44.4. 记录自己的指标
5.4.5.5.
44.5. 添加你自己的公共指标
5.4.5.6.
44.6. 指标仓库
5.4.5.7.
44.7. Dropwizard指标
5.4.5.8.
44.8. 消息渠道集成
5.4.6.
45. 审计
5.4.7.
46. 追踪（Tracing）
5.4.7.1.
46.1. 自定义追踪
5.4.8.
47. 进程监控
5.4.8.1.
47.1. 扩展属性
5.4.8.2.
47.2. 以编程方式
5.4.9.
48. 接下来阅读什么
6.
VI. 部署到云端
6.1.
49. Cloud Foundry
6.1.1.
49.1. 绑定服务
6.2.
50. Heroku
6.3.
51. Openshift
6.4.
52. Google App Engine
6.5.
53. 接下来阅读什么
7.
VII. Spring Boot CLI
7.1.
54. 安装CLI
7.2.
55. 使用CLI
7.2.1.
55.1. 使用CLI运行应用
7.2.1.1.
55.1.1. 推断"grab"依赖
7.2.1.2.
55.1.2. 推断"grab"坐标
7.2.1.3.
55.1.3. 默认import语句
7.2.1.4.
55.1.4. 自动创建main方法
7.2.1.5.
55.1.5. 自定义"grab"元数据
7.2.2.
55.2. 测试你的代码
7.2.3.
55.3. 多源文件应用
7.2.4.
55.4. 应用打包
7.2.5.
55.5. 初始化新工程
7.2.6.
55.6. 使用内嵌shell
7.2.7.
55.7. 为CLI添加扩展
7.3.
56. 使用Groovy beans DSL开发应用
7.4.
57. 接下来阅读什么
8.
VIII. 构建工具插件
8.1.
58. Spring Boot Maven插件
8.1.1.
58.1. 包含该插件
8.1.2.
58.2. 打包可执行jar和war文件
8.2.
59. Spring Boot Gradle插件
8.2.1.
59.1. 包含该插件
8.2.2.
59.2. 声明不带版本的依赖
8.2.2.1.
59.2.1. 自定义版本管理
8.2.3.
59.3. 默认排除规则
8.2.4.
59.4. 打包可执行jar和war文件
8.2.5.
59.5. 就地（in-place）运行项目
8.2.6.
59.6. Spring Boot插件配置
8.2.7.
59.7. Repackage配置
8.2.8.
59.8. 使用Gradle自定义配置进行Repackage
8.2.8.1.
59.8.1. 配置选项
8.2.9.
59.9. 理解Gradle插件是如何工作的
8.3.
60. 对其他构建系统的支持
8.3.1.
60.1. 重新打包存档
8.3.2.
60.2. 内嵌的库
8.3.3.
60.3. 查找main类
8.3.4.
60.4. repackage实现示例
8.4.
61. 接下来阅读什么
9.
IX. How-to指南
9.1.
62. Spring Boot应用
9.1.1.
62.1. 解决自动配置问题
9.1.2.
62.2. 启动前自定义Environment或ApplicationContext
9.1.3.
62.3. 构建ApplicationContext层次结构（添加父或根上下文
9.1.4.
62.4. 创建一个非web（non-web）应用
9.2.
63. 属性&配置
9.2.1.
63.1. 外部化SpringApplication配置
9.2.2.
63.2. 改变应用程序外部配置文件的位置
9.2.3.
63.3. 使用'short'命令行参数
9.2.4.
63.4. 使用YAML配置外部属性
9.2.5.
63.5. 设置生效的Spring profiles
9.2.6.
63.6. 根据环境改变配置
9.2.7.
63.7. 发现外部属性的内置选项
9.3.
64. 内嵌的servlet容器
9.3.1.
64.1. 为应用添加Servlet，Filter或ServletContextListener
9.3.2.
64.2. 改变HTTP端口
9.3.3.
64.3. 使用随机未分配的HTTP端口
9.3.4.
64.4. 发现运行时的HTTP端口
9.3.5.
64.5. 配置SSL
9.3.6.
64.6. 配置Tomcat
9.3.7.
64.7. 启用Tomcat的多连接器（Multiple Connectors）
9.3.8.
64.8. 在前端代理服务器后使用Tomcat
9.3.9.
64.9. 使用Jetty替代Tomcat
9.3.10.
64.10. 配置Jetty
9.3.11.
64.11. 使用Undertow替代Tomcat
9.3.12.
64.12. 配置Undertow
9.3.13.
64.13. 启用Undertow的多监听器
9.3.14.
64.14. 使用Tomcat7
9.3.14.1.
64.14.1. 通过Maven使用Tomcat7
9.3.14.2.
64.14.2. 通过Gradle使用Tomcat7
9.3.15.
64.15. 使用Jetty8
9.3.15.1.
64.15.1. 通过Maven使用Jetty8
9.3.15.2.
64.15.2. 通过Gradle使用Jetty8
9.3.16.
64.16. 使用@ServerEndpoint创建WebSocket端点
9.3.17.
64.17. 启用HTTP响应压缩
9.3.17.1.
64.17.1. 启用Tomcat的HTTP响应压缩
9.3.17.2.
64.17.2. 使用GzipFilter开启HTTP响应压缩
9.4.
65. Spring MVC
9.4.1.
65.1. 编写一个JSON REST服务
9.4.2.
65.2. 编写一个XML REST服务
9.4.3.
65.3. 自定义Jackson ObjectMapper
9.4.4.
65.4. 自定义@ResponseBody渲染
9.4.5.
65.5. 处理Multipart文件上传
9.4.6.
65.6. 关闭Spring MVC DispatcherServlet
9.4.7.
65.7. 关闭默认的MVC配置
9.4.8.
65.8. 自定义ViewResolvers
9.5.
66. 日志
9.5.1.
66.1. 配置Logback
9.5.2.
66.2. 配置Log4j
9.5.2.1.
66.2.1. 使用YAML或JSON配置Log4j2
9.6.
67. 数据访问
9.6.1.
67.1. 配置一个数据源
9.6.2.
67.2. 配置两个数据源
9.6.3.
67.3. 使用Spring Data仓库
9.6.4.
67.4. 从Spring配置分离@Entity定义
9.6.5.
67.5. 配置JPA属性
9.6.6.
67.6. 使用自定义的EntityManagerFactory
9.6.7.
67.7. 使用两个EntityManagers
9.6.8.
67.8. 使用普通的persistence.xml
9.6.9.
67.9. 使用Spring Data JPA和Mongo仓库
9.6.10.
67.10. 将Spring Data仓库暴露为REST端点
9.7.
68. 数据库初始化
9.7.1.
68.1. 使用JPA初始化数据库
9.7.2.
68.2. 使用Hibernate初始化数据库
9.7.3.
68.3. 使用Spring JDBC初始化数据库
9.7.4.
68.4. 初始化Spring Batch数据库
9.7.5.
68.5. 使用一个高级别的数据迁移工具
9.7.5.1.
68.5.1. 启动时执行Flyway数据库迁移
9.7.5.2.
68.5.2. 启动时执行Liquibase数据库迁移
9.8.
69. 批处理应用
9.8.1.
69.1. 在启动时执行Spring Batch作业
9.9.
70. 执行器（Actuator）
9.9.1.
70.1. 改变HTTP端口或执行器端点的地址
9.9.2.
70.2. 自定义'白标'（whitelabel，可以了解下相关理念）错误页面
9.10.
71. 安全
9.10.1.
71.1. 关闭Spring Boot安全配置
9.10.2.
71.2. 改变AuthenticationManager并添加用户账号
9.10.3.
71.3. 当前端使用代理服务器时，启用HTTPS
9.11.
72. 热交换
9.11.1.
72.1. 重新加载静态内容
9.11.2.
72.2. 在不重启容器的情况下重新加载Thymeleaf模板
9.11.3.
72.3. 在不重启容器的情况下重新加载FreeMarker模板
9.11.4.
72.4. 在不重启容器的情况下重新加载Groovy模板
9.11.5.
72.5. 在不重启容器的情况下重新加载Velocity模板
9.11.6.
72.6. 在不重启容器的情况下重新加载Java类
9.11.6.1.
72.6.1. 使用Maven配置Spring Loaded
9.11.6.2.
72.6.2. 使用Gradle和IntelliJ配置Spring Loaded
9.12.
73. 构建
9.12.1.
73.1. 使用Maven自定义依赖版本
9.12.2.
73.2. 使用Maven创建可执行JAR
9.12.3.
73.3. 创建其他的可执行JAR
9.12.4.
73.4. 在可执行jar运行时提取特定的版本
9.12.5.
73.5. 使用排除创建不可执行的JAR
9.12.6.
73.6. 远程调试一个使用Maven启动的Spring Boot项目
9.12.7.
73.7. 远程调试一个使用Gradle启动的Spring Boot项目
9.12.8.
73.8. 使用Ant构建可执行存档（archive）
9.12.9.
73.9. 如何使用Java6
9.12.9.1.
73.9.1. 内嵌Servlet容器兼容性
9.12.9.2.
73.9.2. JTA API兼容性
9.13.
74. 传统部署
9.13.1.
74.1. 创建一个可部署的war文件
9.13.2.
74.2. 为老的servlet容器创建一个可部署的war文件
9.13.3.
74.3. 将现有的应用转换为Spring Boot
9.13.4.
74.4. 部署WAR到Weblogic
9.13.5.
74.5. 部署WAR到老的(Servlet2.5)容器
10.
X.附录
10.1.
附录A. 常见应用属性
10.2.
附录B. 配置元数据
10.2.1.
附录B.1. 元数据格式
10.2.1.1.
附录B.1.1. Group属性
10.2.1.2.
附录B.1.2. Property属性
10.2.1.3.
附录B.1.3. 可重复的元数据节点
10.2.2.
附录B.2. 使用注解处理器产生自己的元数据
10.2.2.1.
附录 B.2.1. 内嵌属性
10.2.2.2.
附录 B.2.2. 添加其他的元数据
10.3.
附录C. 自动配置类
10.3.1.
附录 C.1. 来自spring-boot-autoconfigure模块
10.3.2.
附录C.2. 来自spring-boot-actuator模块
10.4.
附录D. 可执行jar格式
10.4.1.
附录D.1. 内嵌JARs
10.4.1.1.
附录D.1.1. 可执行jar文件结构
10.4.1.2.
附录D.1.2. 可执行war文件结构
10.4.2.
附录D.2. Spring Boot的"JarFile"类
10.4.2.1.
附录D.2.1. 对标准Java "JarFile"的兼容性
10.4.3.
附录D.3. 启动可执行jars
10.4.3.1.
附录D.3.1 Launcher manifest
10.4.3.2.
附录D.3.2. 暴露的存档
10.4.4.
附录D.4. PropertiesLauncher特性
10.4.5.
附录D.5. 可执行jar的限制
10.4.5.1.
附录D.5.1. Zip实体压缩
10.4.5.2.
附录D.5.2. 系统ClassLoader
10.4.6.
附录D.6. 可替代的单一jar解决方案
10.5.
附录E. 依赖版本
Published with GitBook
A
A
Serif
Sans
White
Sepia
Night
Share on Twitter
Share on Google
Share on Facebook
Share on Weibo
Share on Instapaper
Spring-Boot-Reference-Guide
2. 获取帮助
使用Spring Boot遇到麻烦，我们很乐意帮忙！
尝试
How-to’s
－它们为多数常见问题提供解决方案。
学习Spring基础知识－Spring Boot是在很多Spring项目上构建的，查看
spring.io
站点可以获取大量参考文档。如果你刚开始使用Spring，可以尝试其中的一个
指导
。
提问题－我们时刻监控着
stackoverflow.com
上标记
spring-boot
的问题。
在
github.com/spring-projects/spring-boot/issues
报告Spring Boot的bug。
注
：Spring Boot的全部都是开源的，包括文档！如果你发现问题，或只是想提高它们，请
参与进来
！